<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--

  @(#)package.html	1.60 98/01/27

  Copyright 1998 Sun Microsystems, Inc. 901 San Antonio Road, 
  Palo Alto, California, 94303, U.S.A.  All Rights Reserved.

  This software is the confidential and proprietary information of Sun
  Microsystems, Inc. ("Confidential Information").  You shall not
  disclose such Confidential Information and shall use it only in
  accordance with the terms of the license agreement you entered into
  with Sun.

  CopyrightVersion 1.2

-->
</head>
<body bgcolor="white">

This package is the base client API that is accesible by 
application level components to manipulate mapper objects.

<h2>Specifications</h2>

<h3>Mappers life-cycle</h3>
<p>
	A mapper object (ie. isntance of {@link fr.norsys.mapper.core.Mapper} interface) may be either 
	acquired through method {@link fr.norsys.mapper.manager.Manage#getMapper(String)} invoked in
	a manager or by creating user-defined mappers (ie. composite mappers). 
	The basic life-cycle contract of mapper objects is that:
	<ul>
		<li>A Manage-acquired Mapper object must be returned to the manager
			by call to {@link fr.norsys.mapper.manager.Manage#release(Mapper)} method. A released Mapper
			object may no longer be used directly or indirectly (eg. through the use 
			of a {@link fr.norsys.mapper.core.JoinMapper}),</li>
		<li>A user-defined Mapper object must not be returned to the manager. Disposal
			should be left to the garbage collector.
		</li>
	</ul>				
</p>
<p>
	A mapper is associated with a single source object ({@link fr.norsys.mapper.spi.Source}) within
	the context of a single manager. This association is fixed at configuration 
	time by method {@link fr.norsys.mapper.manager.Manager#link(String,String)}.
</p>
<h2>Documentation</h2>

<ul>
  <li>see the <a href="https://srvue.norsys.fr/framework-ldap/doc/DAA.doc">architecture</a> 
	document </li>
</ul>

<!-- Put @see and @since tags down here. -->

</body>
</html>